30장 Date
표준 빌트인 객체 Date는 날짜와 시간을 위한 메서드를 제공하는 빌트인 객체이면서 생성자 함수이다.
UTC는 국제 표준시를 말하고, GMT(그리니치 평균시) 와 혼용하여 사용되기도 하지만, 약간의 오차가 있어서 기술적인 표기에서는 UCT가 사용된다.
현재 날짜와 시간은 JS코드가 실행된 시스템의 시계에 의해 결정된다.
Date 생성자 함수
Date 생성자 함수로 생성한 Date 객체는 내부적으로 날짜와 시간을 나타내는 정수값을 갖는다.
1970년 1월을 1일 00:00:00을 기점으로 Date객체가 나타내는 시점까지의 밀리초를 나타낸다.
new Date()
인수없이 호출하면 현재 날짜와 시간을 가지는 Date 객체 반환.
new Date(); // -> Mon Jul 06 2020 01:03:18 GMT+0900 (대한민국 표준시)
new 연사자 없이 호출하면 Date 객체를 반환하지 않고 현재 시간을 문자열로 반환.
Date(); // -> "Mon Jul 06 2020 01:10:47 GMT+0900 (대한민국 표준시)"
new Date(milliseconds)
밀리초를 인수로 전달하면 시간 계산해서 Date 객체로 반환.
// 한국 표준시 KST는 협정 세계시 UTC에 9시간을 더한 시간이다.
new Date(0); // -> Thu Jan 01 1970 09:00:00 GMT+0900 (대한민국 표준시)
/*
86400000ms는 1day를 의미한다.
1s = 1,000ms
1m = 60s * 1,000ms = 60,000ms
1h = 60m * 60,000ms = 3,600,000ms
1d = 24h * 3,600,000ms = 86,400,000ms
*/
new Date(86400000); // -> Fri Jan 02 1970 09:00:00 GMT+0900 (대한민국 표준시)
new Date(dateString)
문자열로 시간을 인수로 전달하면 Date 객체 반환
단, date.parse에 의해 해석 가능한 형식이어야 한다.
new Date('May 26, 2020 10:00:00');
// -> Tue May 26 2020 10:00:00 GMT+0900 (대한민국 표준시)
new Date('2020/03/26/10:00:00');
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)
new Date(year, month[,day, hour, minute, second, millisecond])
// 월을 나타내는 2는 3월을 의미한다. 2020/3/1/00:00:00:00
new Date(2020, 2);
// -> Sun Mar 01 2020 00:00:00 GMT+0900 (대한민국 표준시)
// 월을 나타내는 2는 3월을 의미한다. 2020/3/26/10:00:00:00
new Date(2020, 2, 26, 10, 00, 00, 0);
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)
// 다음처럼 표현하면 가독성이 훨씬 좋다.
new Date('2020/3/26/10:00:00:00');
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)
Date 메서드
Date.new
현재시간까지의 밀리초를 숫자로 반환.
const now = Date.now(); // -> 1593971539112
// Date 생성자 함수에 숫자 타입의 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00(UTC)을
// 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 나타내는 Date 객체를 반환한다.
// (30.1.2절 "new Date(milliseconds)" 참고)
new Date(now); // -> Mon Jul 06 2020 02:52:19 GMT+0900 (대한민국 표준시)
Date.parse
인수로 전달된 시간까지의 시간을 밀리초로 반환
// UTC
Date.parse('Jan 2, 1970 00:00:00 UTC'); // -> 86400000
// KST
Date.parse('Jan 2, 1970 09:00:00'); // -> 86400000
// KST
Date.parse('1970/01/02/09:00:00'); // -> 86400000
Date.UTC
인수로 전달된 시간까지의 밀리초 반환.
#new Date(year, month [,day, hour, minute, second, millisecond]) 와 같은 형식의 인수 사용.
Date.UTC(1970, 0, 2); // -> 86400000
Date.UTC('1970/1/2'); // -> NaN
Date.prototype.getFullYear
Date 객체의 연도를 정수로 반환.
new Date('2020/07/24').getFullYear(); // -> 2020
Date.prototype.setFullYear
Date 객체의 연도를 정수로 설정
월, 일도 설정 가능.
const today = new Date();
// 년도 지정
today.setFullYear(2000);
today.getFullYear(); // -> 2000
// 년도/월/일 지정
today.setFullYear(1900, 0, 1);
today.getFullYear(); // -> 1900
Date.prototype.getMonth
Date 객체의 월을 나타내는 0~11 정수 반환.
1월은 0, 12월은 11
new Date('2020/07/24').getMonth(); // -> 6
Date.prototype.setMonth
const today = new Date();
// 월 지정
today.setMonth(0); // 1월
today.getMonth(); // -> 0
// 월/일 지정
today.setMonth(11, 1); // 12월 1일
today.getMonth(); // -> 11
Date.prototype.getDate
new Date('2020/07/24').getDate(); // -> 24
Date.prototype.setDate
const today = new Date();
// 날짜 지정
today.setDate(1);
today.getDate(); // -> 1
Date.prototype.getDay
일요일 ~ 토요일 ( 0 ~ 6 )로 반환.
new Date('2020/07/24').getDay(); // -> 5
Date.prototype.getHours
new Date('2020/07/24/12:00').getHours(); // -> 12
Date.prototype.setHours
const today = new Date();
// 시간 지정
today.setHours(7);
today.getHours(); // -> 7
// 시간/분/초/밀리초 지정
today.setHours(0, 0, 0, 0); // 00:00:00:00
today.getHours(); // -> 0
Date.prototype.getMinutes
new Date('2020/07/24/12:30').getMinutes(); // -> 30
Date.prototype.setMinutes
const today = new Date();
// 분 지정
today.setMinutes(50);
today.getMinutes(); // -> 50
// 분/초/밀리초 지정
today.setMinutes(5, 10, 999); // HH:05:10:999
today.getMinutes(); // -> 5
Date.prototype.getSeconds
new Date('2020/07/24/12:30:10').getSeconds(); // -> 10
Date.prototype.setSeconds
const today = new Date();
// 초 지정
today.setSeconds(30);
today.getSeconds(); // -> 30
// 초/밀리초 지정
today.setSeconds(10, 0); // HH:MM:10:000
today.getSeconds(); // -> 10
Date.prototype.getMilliseconds
new Date('2020/07/24/12:30:10:150').getMilliseconds(); // -> 150
Date.prototype.setMilliseconds
const today = new Date();
// 밀리초 지정
today.setMilliseconds(123);
today.getMilliseconds(); // -> 123
Date.prototype.getTime
Date 객체의 시간까지 경과된 밀리초 반환
new Date('2020/07/24/12:30').getTime(); // -> 1595561400000
Date.prototype.setTime
경과된 밀리초 설정
const today = new Date();
// 1970년 1월 1일 00:00:00(UTC)를 기점으로 경과된 밀리초 설정
today.setTime(86400000); // 86400000는 1day를 나타낸다.
console.log(today); // -> Fri Jan 02 1970 09:00:00 GMT+0900 (대한민국 표준시)
Date.prototype.getTimezoneOffset
UTC와 Date 객체에 지정된 local 시간과의 차이를 분 단위로 반환
const today = new Date(); // today의 지정 로캘은 KST다.
//UTC와 today의 지정 로캘 KST와의 차이는 -9시간이다.
today.getTimezoneOffset() / 60; // -9
Date.prototype.toDateString
사람이 읽을 수 있는 형식의 문자열로 Date 객체의 날짜 반환
const today = new Date('2020/7/24/12:30');
today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toDateString(); // -> Fri Jul 24 2020
Date.prototype.toTimeString
Date 객체의 시간을 표현한 문자열 반환.
const today = new Date('2020/7/24/12:30');
today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toTimeString(); // -> 12:30:00 GMT+0900 (대한민국 표준시)
Date.prototype.toISOString
ISO 8601 형식으로 Date 객체의 날짜와 시간 문자열로 반환.
const today = new Date('2020/7/24/12:30');
today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toISOString(); // -> 2020-07-24T03:30:00.000Z
today.toISOString().slice(0, 10); // -> 2020-07-24
today.toISOString().slice(0, 10).replace(/-/g, ''); // -> 20200724
Date.prototype.toLocaleString
local 기준으로 Date 객체와 날짜 시간 표현한 문자열 반환
인수 생략하면 브라우저가 동작 중인 시스템의 local로 계산
const today = new Date('2020/7/24/12:30');
today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toLocaleString(); // -> 2020. 7. 24. 오후 12:30:00
today.toLocaleString('ko-KR'); // -> 2020. 7. 24. 오후 12:30:00
today.toLocaleString('en-US'); // -> 7/24/2020, 12:30:00 PM
today.toLocaleString('ja-JP'); // -> 2020/7/24 12:30:00
Date.prototype.toLocaleTimeString
Date 객체의 시간을 표현한 문자열 반환
const today = new Date('2020/7/24/12:30');
today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toLocaleTimeString(); // -> 오후 12:30:00
today.toLocaleTimeString('ko-KR'); // -> 오후 12:30:00
today.toLocaleTimeString('en-US'); // -> 12:30:00 PM
today.toLocaleTimeString('ja-JP'); // -> 12:30:00